Release 10.1A: OpenEdge Development:
Messaging and ESB

Receiving messages from a queue

In the PTP domain, applications receive messages from a queue. The application calls the receiveFromQueue procedure in ptpsession.p or jmssession.p with the queue name and a handle to the Message Consumer object. The application can pass a JMS properties selector expression to the receiveFromQueue procedure call to specify which messages the receiver wants to receive from the queue.

Queue browsing

The PTP model supports queue browsing, a mechanism that lets an application view the content of messages in a queue without actually consuming (receiving) the messages. The 4GL-JMS API supports queue browsing through the browseQueue procedure in the PTP Session object or JMS Session object.

The messages can be handled by the message handler in the same way as messages coming from a receiveFromQueue procedure call, but they are not acknowledged and are not subject to the transactional context of the session. (See the Java Message Service specification and SonicMQ Programming Guide for details on queue browsing.)